<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
	<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
	<title>Document</title>
	<link rel="stylesheet" href="css/reset.css" />
	<link rel="stylesheet" href="css/kzt.css" />
	<script type="text/javascript" src="js/jquery.js"></script>
	<script type="text/javascript" src="js/page.js"></script>
	<script type="text/javascript" src="js/linkjs.js"></script>
	<script type="text/javascript" src="js/qos.js"></script>
</head>
<body>
	<div class="header">
		<div id="append"></div>
		<script> 
            $("#append").load("header.html");
        </script>

		<div class="navBigbox">
			<div class="navsubBox">
				<ul class="indexMenu">
					<li class="home-btn">首页</li>
					<li class="cp-btn">产品</li>
					<li class="kf-btn">开发<a class="checked-arrow"></a></li>
					<li class="kzt-btn">控制台</li>
					<li class="Qos-btn">帮助与支持</li>
				</ul>
			</div>
		</div>
		<div class="clear"></div>
	</div>

	<div class="contentBox">
		<h3>
			首页产品 &gt;<a style="color:#50b9e7">&nbsp;开发</a>
		</h3>
		<ul class="leftbar">
			<!--<li class="kfqzb">开发前准备</li>-->
			<li class="kskf">开始开发 </li>
			<li class="lljk">流量接口</li>
			<li class="qosjs-sp">QOS介绍</li>
			<li class="qos-list1 checkedFontBlue"><span>&bull;</span>动态Qos资源申请 <a></a></li>
			<li class="qos-list2"><span>&bull;</span>动态Qos资源修改</li>
			<li class="qos-list3"><span>&bull;</span>动态Qos资源释放</li>
			<li class="qos-list4"><span>&bull;</span>Qos状态事件通知</li>
		</ul>
		<div class="developmentBox">
			<div class="rightbar support-content developmentcon_1" style="position:relative;z-index:2;border:1px solid #ccc;top:-1px;">
				<h4>资源申请<a>(ComplexDynamicQoS)</a></h4>
				<div class="support1page developmentPage1">
					<p>服务英文名：ComplexDynamicQoS</p>
					<p>服务中文名：资源申请</p>
					<p>服务概述：用户Qos加速申请资源。</p>
				</div>
				
			
				<div class="clear"></div>
				<div class="qos-nav">
					<p class="qos-p active">请求参数<span></span></p>
					<div class="support1page developmentPage1  ">
						<table class="developmentTable">
						<tr>
							<th style="">属性名称</th>
							<th>是否必填</th>
							<th>描述</th>
							<th>取值</th>
						</tr>
						<tr class="tr-btn">
							<td><span class="tr-nav-icon"></span><a>UserIdentifier</a></td>
							<td>是</td>
							<td>用户标识</td>
							<td></td>
						</tr>
						<tr class="tr-close">
							<td><span class="tr-navlist-icon"></span><a>IP</a></td>
							<td>是</td>
							<td>私网IP</td>
							<td>IP地址</td>
						</tr>
						<tr class="tr-close">
							<td><span class="tr-navlist-icon"></span><a>IMSI</a></td>
							<td>否</td>
							<td>IMSI</td>
							<td>格式为86+手机号码，比如8618900000000-6</td>
						</tr>
						<tr class="tr-close">
							<td><span class="tr-navlist-icon"></span><a >MSISDN</a></td>
							<td>否</td>
							<td>设备号</td>
							<td></td>
						</tr>
						<tr>
							<td><a>ServiceId</a></td>
							<td>是</td>
							<td>业务标示</td>
							<td>
								取值QoS_OTT1000,
QoS_OTT2000,
QoS_OTT3000,
QoS_OTT4000, 规则见<a href="#ywczb" style="float: none;">业务参数对照表</a>
							</td>
						</tr>
						<tr>
							<td><a>Duration</a></td>
							<td>否</td>
							<td>加速时长</td>
							<td>100~1800
							</td>
						</tr>
						<tr>
							<td><a>OTTchargingId</a></td>
							<td>是</td>
							<td>渠道ID</td>
							<td>注册时填写的渠道ID</td>
						</tr>
						<tr class="tr-btn1">
							<td><span class="tr-nav-icon"></span><a >ResourceFeatureProperties</a></td>
							<td>是</td>
							<td>业务类型</td>
							<td>业务类型、业务流信息和QoS信息等</td>
						</tr>
						<tr class="tr-close1">
							<td><span class="tr-navlist-icon"></span><a >Type</a></td>
							<td>是</td>
							<td>类别</td>
							<td>
								<p>类别包括：</p>
								<p>0: 音频;</p>
								<p>1: 视频; </p>
								<p>2: 文本;   </p>
								<p>3: 应用;</p> 
								<p>4: 控制; </p>
								<p>5: 文本;</p>
								<p>6: 信息; </p>
								<p>0xFFFFFFFF: 其他</p>
							</td>
						</tr>
						<tr class="tr-close1">
							<td><span class="tr-navlist-icon"></span><a>Priority</a></td>
							<td>是</td>
							<td></td>
							<td>QoS属性的优先级，取值：1~15，值越大，优先级越高</td>
						</tr>
						<tr class="tr-close1 tr-sec-list">
							<td><span class="tr-navlist-icon"></span><a >FlowProperties</a></td>
							<td>是</td>
							<td></td>
							<td>包括IP五元组及所需的带宽等</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a >Direction</a></td>
							<td>是</td>
							<td></td>
							<td>
								<p>0: 上游</p>
								<p>1: 下游</p>
								<p>2: 双向</p>
							</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a >SourceIpAddress</a></td>
							<td>是</td>
							<td></td>
							<td>
								<p>业务流的IPv4源地址或源IPv6前缀，应该为终端的IP，而不是NAT转换后的IP。如果业务平台不能确认是否是NAT转换后的IP，可以省略该参数或使用通配符，但用户标识必须使用IMSI/MSISDN。支持三种格式：</p>
								<p>1. ipno:An IPv4 or IPv6 number in dotted-quad or canonical IPv6 form.</p>
								<p>2. ipno/bits:An IP number as above with a mask width of the form 1.2.3.4/24.</p>
								<p>3. 0.0.0.0/0 or the IPv6 equivalent means "any".</p>
							</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a>DestinationIpAddress</a></td>
							<td>是</td>
							<td></td>
							<td>
								<p>业务流的IPv4目标地址或目标IPv6前缀，不能是通配符。如果目标设备在NAT设备后，则必须是NAT转换后的IP，即源终端可见的IP。支持二种格式：</p>
								<p>1. ipno:An IPv4 or IPv6 number in dotted-quad or canonical IPv6 form.</p>
								<p>2. ipno/bits:An IP number as above with a mask width of the form 1.2.3.4/24.</p>
							</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a>SourcePort</a></td>
							<td>否</td>
							<td></td>
							<td>
								<p>1、源端口号，不携带表示任意源端口</p>
								<p>2、不能确认是否存在NAT转换时省略该参数</p>
							</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a>DestinationPort</a></td>
							<td>否</td>
							<td></td>
							<td>目标端口号，不携带表示任意目的端口。如果目标设备在NAT设备后，则必须是NAT转换后的端口，即源终端可见的端口</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a >Protocol</a></td>
							<td>否</td>
							<td>协议类型</td>
							<td>
								<p>“IP”：任意IP协议</p>
								<p>“UDP”：UDP协议</p>
								<p>“TCP”：TCP协议</p>
							</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a>MaximumUpStreamSpeedRate</a></td>
							<td>是</td>
							<td>上行最小峰值速率</td>
							<td>上行最小峰值速率，单位为bps</td>
						</tr>
						<tr class="tr-close1 tr-close-list">
							<td><span class="tr-sec-icon"></span><a >MaximumDownStreamSpeedRate</a></td>
							<td>是</td>
							<td>下行最小峰值速率</td>
							<td>下行最小峰值速率，单位为bps</td>
						</tr>
						<tr>
							<td><a>CallBackURL</a></td>
							<td>否</td>
							<td>加速后通知回调地址</td>
							<td>开发者信息完善的回调地址</td>
						</tr>
					</table>
					</div>
					<p class="qos-p active">业务参数对照表格<a name="ywczb"></a></p>
					<div class="support1page developmentPage1">
					
					<table class="developmentTable">
						<tr>
							<th>Service-ID</th>
							<th>MaximumUpStreamSpeedRate</th>
							<th>业务场景</th>
							<th>说明</th>
						</tr>
						<tr>
							<td>QoS_OTT1000</td>
							<td>12800kbs、38400kbs、76800kbs、131072kbs</td>
							<td>实时游戏</td>
							<td>时延50毫秒，丢包率10-3，可选择最低带宽保障</td>
						</tr>
						<tr>
							<td>QoS_OTT2000</td>
							<td>13107200kbs、26214400Mbps、39321600Mbps，52428800Mbps</td>
							<td>视频直播</td>
							<td>时延300毫秒，丢包率10-6可选择最低带宽保障</td>
						</tr>
						<tr>
							<td>QoS_OTT3000</td>
							<td>0</td>
							<td>浏览、视频、FTP、P2P下载、聊天、email等</td>
							<td>时延300毫秒，丢包率10-6</td>
						</tr>
						<tr>
							<td>QoS_OTT4000</td>
							<td>0</td>
							<td>语音、直播视频、交互式游戏</td>
							<td>时延100毫秒，丢包率10-3</td>
						</tr>	
					</table>
				</div>			
					<p class="qos-p active">输入样例<span></span></p>
					<div class="support1page developmentPage1  ">
						<div class="black">
							<p>资源申请报文实例：</p>
							<p>{</p>
							<p>&nbsp;&nbsp;"UserIdentifier": {</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"IP": "10.34.44.133",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"IMSI": "460110129365955"</p>
							<p>&nbsp;&nbsp;},</p>
							<p>&nbsp;&nbsp;"ServiceId": "ottgames",</p>
							<p>&nbsp;&nbsp;"ResourceFeatureProperties": [</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;{</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"Type": 4,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"Priority": 12,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"FlowProperties": [</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"Direction": 2,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"SourceIpAddress": "10.34.44.133",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"DestinationIpAddress": "61.135.169.125",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"SourcePort": 3184,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"DestinationPort": 80,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"Protocol": "TCP",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"MaximumUpStreamSpeedRate": 102400,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"MaximumDownStreamSpeedRate": 409600</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;],</p>
							<p>&nbsp;&nbsp;"MinimumUpStreamSpeedRate": 102400,</p>
							<p>&nbsp;&nbsp;"MinimumDownStreamSpeedRate": 409600</p>
							<p>&nbsp;&nbsp;}</p>
							<p>&nbsp;&nbsp;],</p>
							<p>&nbsp;&nbsp;"Duration": 60,</p>
							<p>&nbsp;&nbsp;"CallBackURL": "http://122.224.73.168:30052/report/status/"</p>
							<p>}</p>
							
						</div>
					</div>
					<p class="qos-p active">输出参数<span></span></p>
					<div class="support1page developmentPage1  ">
						<table class="developmentTable">
							<tr>
								<th style="width:200px;">属性名称</th>
								<th>必填情况</th>
								<th>描述</th>
								<th>取值</th>
							</tr>
							<tr>
								<td>ResultCode</td>
								<td>是</td>
								<td>响应码</td>
								<td>
									<p>0：Successful (成功)</p>
									<p>127：Priority Improved  (优先改善)</p>
									<p>128：Insufficient resources (资源不足)</p>
									<p>129：Invalid service information (无效的服务信息)</p>
									<p>130：Requested service not authorized (请求的服务没有授权)</p>
									<p>131：User not online (用户不在线)</p>
									<p>132：User not existent (用户不存在)</p>
									<p>254：Auth Failed (验证失败)</p>
									<p>255：Failed – unspecified reason   (失败-未指定的原因)</p>
								</td>
							</tr>
							<tr>
								<td>ResultMessage</td>
								<td>是</td>
								<td>响应描述</td>
								<td>参见ResultCode的描述，如ResultCode = 128时，ResultMessage 为 “Insufficient resources”</td>
							</tr>
							<tr>
								<td>CorrelationId</td>
								<td>否</td>
								<td>QoS资源申请流水号</td>
								<td>成功响应时必须携带，唯一标识一次QoS请求，业务平台在后续消息中应包含该参数。</td>
							</tr>
							<tr class="tr-btn">
								<td><span class="tr-nav-icon"></span>UserIdentifier</td>
								<td>否</td>
								<td></td>
								<td></td>
							</tr>
							<tr class="tr-close">
								<td><span class="tr-navlist-icon"></span>IMSI</td>
								<td>否</td>
								<td></td>
								<td>参数回填</td>
							</tr>
							<tr class="tr-close">
								<td><span class="tr-navlist-icon"></span>IP</td>
								<td>否</td>
								<td></td>
								<td>参数回填</td>
							</tr>
							<tr>
								<td>OTTchargingId</td>
								<td>否</td>
								<td></td>
								<td>参数回填</td>
							</tr>	
						</table>
					</div>
					<p class="qos-p active">输出样例<span></span></p>
					<div class="support1page developmentPage1  ">
						<div class="black">
							<p>HTTP/1.1 201 OK</p>
							<p>Content-Type: application/json{</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"ResultCode": 0,</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"ResultMessage": "Successful",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"CorrelationId": "00000000002600000000000t20160627070028",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"UserIdentifier": {</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"IMSI": "460036181123180",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"MSISDN": "8618049843363",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"IP": "10.54.115.251"</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;}</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"OTTchargingId": "XUNYOU"</p>
							<p>}</p>
						</div>
					</div>
					<p class="qos-p active">异常输出<span></span></p>
					<div class="support1page developmentPage1  ">
						<table class="developmentTable">
							<tr>
								
								<th>属性名称</th>
								<th>必填情况</th>
								<th>描述</th>
								<th>取值</th>
							</tr>
							<tr class="tab-big">
								
								<td>err_code</td>
								<td>是</td>
								<td>系统错误编码</td>
								<td>&nbsp;</td>
							</tr>
							<tr class="tab-big">
								
								<td>err_desc</td>
								<td>是</td>
								<td>系统错误编码</td>
								<td>&nbsp;</td>
							</tr>	
						</table>
					</div>
					<p class="qos-p active">异常输出样例<span></span></p>
					<div class="support1page developmentPage1  ">
						<div class="black">
							<p>Content-Type: application/json</p>
							<p>{</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"err_code": "9003",</p>
							<p>&nbsp;&nbsp;&nbsp;&nbsp;"err_desc": ""</p>
							<p>}</p>
						</div>
					</div>
					
				</div>		
			</div>
		</div>
	</div>
	<!--悬浮在右侧的定位菜单 begin-->
	<div class="wrapper-nav">
		<dl class="td-dl" style="background: #f0f0f0;">
			<dd><p>快速导航</p></dd>			
		</dl>
		<dl class="td-dl">			
			<dd><p>请求参数</p></dd>
			<dd><p>业务参数对照表格</p></dd>
			<dd><p>输入样例</p></dd>
			<dd><p>输出参数</p></dd>
			<dd><p>输出样例</p></dd>
			<dd><p>异常输出</p></dd>
			<dd><p>异常输出样例</p></dd>
			<!--<dd><p>服务地址</p></dd>-->
		</dl>
	</div>
	<!--悬浮在右侧的定位菜单 end-->
	<div id="append-bot"></div>
	<script> 
        $("#append-bot").load("footer.html");
    </script>
</body>
</html>